home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / ureadc.z / ureadc
Encoding:
Text File  |  1998-10-30  |  5.8 KB  |  132 lines
  1.  
  2.  
  3.  
  4. uuuurrrreeeeaaaaddddcccc((((DDDD3333))))                                                          uuuurrrreeeeaaaaddddcccc((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _uuuu_rrrr_eeee_aaaa_dddd_cccc - copy a character to space described by _uuuu_iiii_oooo(D4) structure
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_uuuu_iiii_oooo_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _uuuu_rrrr_eeee_aaaa_dddd_cccc_((((_iiii_nnnn_tttt _c_,,,, _uuuu_iiii_oooo______tttt _****_u_i_o_p_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _c         The character to be copied.
  18.  
  19.      _u_i_o_p      Pointer to the _uuuu_iiii_oooo structure.
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _uuuu_rrrr_eeee_aaaa_dddd_cccc copies the character _c into the space described by the _uuuu_iiii_oooo
  23.      structure pointed to by _u_i_o_p.
  24.  
  25.      The _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg member of the _uuuu_iiii_oooo structure specifies the type of space to
  26.      which the copy is made.  If _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to _UUUU_IIII_OOOO______SSSS_YYYY_SSSS_SSSS_PPPP_AAAA_CCCC_EEEE the
  27.      character is copied to a kernel address.  If _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to
  28.      _UUUU_IIII_OOOO______UUUU_SSSS_EEEE_RRRR_SSSS_PPPP_AAAA_CCCC_EEEE the character is copied to a user address.
  29.  
  30.      If the character is successfully copied, _uuuu_rrrr_eeee_aaaa_dddd_cccc updates the appropriate
  31.      members of the _uuuu_iiii_oooo and _iiii_oooo_vvvv_eeee_cccc(D4) structures to reflect the copy
  32.      (_uuuu_iiii_oooo______oooo_ffff_ffff_ssss_eeee_tttt and _iiii_oooo_vvvv______bbbb_aaaa_ssss_eeee are incremented and _uuuu_iiii_oooo______rrrr_eeee_ssss_iiii_dddd and _iiii_oooo_vvvv______llll_eeee_nnnn are
  33.      decremented).
  34.  
  35.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  36.      _uuuu_rrrr_eeee_aaaa_dddd_cccc returns _0000 on success or an error number on failure.
  37.  
  38. UUUUSSSSAAAAGGGGEEEE
  39.    LLLLeeeevvvveeeellll
  40.      Base only if _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to _UUUU_IIII_OOOO______UUUU_SSSS_EEEE_RRRR_SSSS_PPPP_AAAA_CCCC_EEEE.
  41.  
  42.      Base or Interrupt if _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to _UUUU_IIII_OOOO______SSSS_YYYY_SSSS_SSSS_PPPP_AAAA_CCCC_EEEE.
  43.  
  44.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  45.      May sleep if _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is set to _UUUU_IIII_OOOO______UUUU_SSSS_EEEE_RRRR_SSSS_PPPP_AAAA_CCCC_EEEE.
  46.  
  47.      Driver-defined basic locks and read/write locks may be held across calls
  48.      to this function if _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is _UUUU_IIII_OOOO______SSSS_YYYY_SSSS_SSSS_PPPP_AAAA_CCCC_EEEE but may not be held if
  49.      _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg is _UUUU_IIII_OOOO______UUUU_SSSS_EEEE_RRRR_SSSS_PPPP_AAAA_CCCC_EEEE.
  50.  
  51.      Driver-defined sleep locks may be held across calls to this function
  52.      regardless of the value of _uuuu_iiii_oooo______ssss_eeee_gggg_ffff_llll_gggg.
  53.  
  54.    WWWWaaaarrrrnnnniiiinnnnggggssss
  55.      When holding locks across calls to this function, multithreaded drivers
  56.      must be careful to avoid creating a deadlock.  During the data transfer,
  57.      page fault resolution might result in another I/O to the same device.
  58.      For example, this could occur if the driver controls the disk drive used
  59.      as the swap device.
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. uuuurrrreeeeaaaaddddcccc((((DDDD3333))))                                                          uuuurrrreeeeaaaaddddcccc((((DDDD3333))))
  70.  
  71.  
  72.  
  73. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  74.      _iiii_oooo_vvvv_eeee_cccc(D4), _uuuu_iiii_oooo(D4), _uuuu_iiii_oooo_mmmm_oooo_vvvv_eeee(D3), _uuuu_wwww_rrrr_iiii_tttt_eeee_cccc(D3)
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.